2021.1 (latest)

Release Notes

On this page:

2021.1.4 Maintenance Release

2021.1.4 Maintenance Release [2021-11-02]

Changelog Overview

  • 8 New Features
  • 11 Improvements
  • 52 Bug Fixes
  • 8 Chores
  • 4 Tests
  • 83 Total Tickets

New Features

  • app-admin_essentials:2.25.42-2021.1.28 [10-14-2021] - Edited import dialog to use a new validation method.
  • app-automation_studio:3.35.20-2021.1.68 [10-14-2021] - Tasks can now retry an execution after a failure on the Gen 2 canvas.
  • app-automation_studio:3.35.20-2021.1.67 [10-13-2021] - Created new methods to handle processing and importing of Automations.
  • app-form_builder:4.10.1-2021.1.8 [10-13-2021] - Introduced an internal processing function to improve the usability of templates with IAP Pre-builts.
  • app-json_forms:1.30.12-2021.1.9 [10-13-2021] - Created new methods to handle processing and importing JSON Forms.
  • app-mop:6.10.2-2021.1.8 [10-13-2021] - Introduced an internal processing function to improve the usability of templates with IAP Pre-builts.
  • app-operations_manager:1.47.0-2021.1.43 [10-01-2021] - Added test strategy and app functionality documentation to the repo.
  • app-workflow_builder:5.40.5-2021.1.34 [10-14-2021] - Added the ability to retry tasks on the Gen 1 canvas.

Improvements

  • app-admin_essentials:2.25.42-2021.1.28 [10-01-2021] - Added the ability to show previous Pre-built versions.
  • app-admin_essentials:2.25.42-2021.1.27 [10-09-2021] - Fixed an issue where the Current Operations view would not render if Workflow Engine was not running.
  • app-automation_studio:3.35.20-2021.1.71 [10-22-2021] - Enhanced the Gen 2 variable promotion to resolve potential migration conflict scenarios.
  • app-mop:6.10.2-2021.1.9 [10-21-2021] - Added more descriptions to the reviewSummary task documentation.
  • app-workflow_engine:9.6.32-2021.1.85 [10-26-2021] - Prevent task worker activation during shutdown.
  • app-workflow_engine:9.6.32-2021.1.79 [10-13-2021] - Added the ability to retry a task. Also added configuration options for retry limit, retry delay, and manual retry.
  • pronghorn-core:12.1.24-2021.1.58 [11-01-2021] - IAP now waits to process events until every service is ready. IAP also stops listening to events on shutdown.
  • pronghorn-core:12.1.24-2021.1.56 [10-29-2021] - Added logging to Integrations to help with troubleshooting.
  • pronghorn-core:12.1.24-2021.1.55 [10-21-2021] - Removed unnecessary arguments from the service module and the $ENCRYPTED global variable.
  • pronghorn-core:12.1.24-2021.1.49 [10-14-2021] - Introduced the ability to overwrite existing IAP components when importing a Pre-built Automation.
  • pronghorn-core:12.1.24-2021.1.49 [10-07-2021] - Introduced an auto-migration script to add version status to each pre-built repository configuration.

Bug Fixes

  • adapter-nso:7.1.3-2021.1.3 [10-06-2021] - Added support for outside augment statements in service models.
  • app-admin_essentials:2.25.42-2021.1.32 [10-23-2021] - Increased the content height of the warning dialog that displays when installing a Pre-built that will overwrite existing components.
  • app-admin_essentials:2.25.42-2021.1.31 [10-22-2021] - Fixed dependence installation error message.
  • app-admin_essentials:2.25.42-2021.1.30 [10-20-2021] - Fixed a bug that caused an incorrect listing of Pre-built items in the sidebar menu.
  • app-admin_essentials:2.25.42-2021.1.29 [10-20-2021] - When browsing Pre-built Automations, a warning message is now provided for Pre-builts with a version older than the IAP environment version.
  • app-admin_essentials:2.25.42-2021.1.28 [10-14-2021] - Fixed various overwrite dialog issues in Admin Essentials.
  • app-admin_essentials:2.25.42-2021.1.28 [10-14-2021] - The Update button now displays in the Admin Essentials Pre-Built UI.
  • app-admin_essentials:2.25.42-2021.1.28 [10-12-2021] - Completed design audit and made updates to various UI elements and style components.
  • app-admin_essentials:2.25.42-2021.1.26 [10-07-2021] - Added Pre-built links for Operation Manager content.
  • app-admin_essentials:2.25.42-2021.1.25 [10-05-2021] - Import dialog state is cleared when the onFileClear event is called.
  • app-automation_catalog:2.10.6-2021.1.12 [11-04-2021] - Fixed bug where Pre-builts with an ac-agenda-job item but no workflows or forms failed to import. This fix sets the importMap default options as "true".
  • app-automation_catalog:2.10.6-2021.1.11 [11-04-2021] - Added parameter to processAutomations to fix issue where importing an Automation Catalog item in a Pre-built incorrectly referenced the dependencies.
  • app-automation_catalog:2.10.6-2021.1.10 [10-08-2021] - Fixed date selector input for automation scheduling to avoid setting invalid date by the user.
  • app-automation_catalog:2.10.6-2021.1.9 [10-06-2021] - Added automatic focusing on the automation name field. Cursor will automatically move to the new name field when creating a new automation.
  • app-automation_catalog:2.10.6-2021.1.8 [10-01-2021] - Added error notification toast message when automation cannot be scheduled due to invalid JSON Form content.
  • app-automation_studio:3.35.20-2021.1.69 [10-14-2021] - Fixed the Gen 2 decision task dropdown button to remove text overlay.
  • app-automation_studio:3.35.20-2021.1.65 [10-07-2021] - The promoteOutput checkbox now displays the correct initial value.
  • app-automation_studio:3.35.20-2021.1.64 [10-06-2021] - Tasks on the Gen 2 canvas can now promote their data values up to a parent workflow.
  • app-automation_studio:3.35.20-2021.1.63 [10-06-2021] - Fixed error in finding transition cycles and disallowing users from creating one.
  • app-automation_studio:3.35.20-2021.1.62 [10-05-2021] - Modified app.jsx and verified there is no crash when searching Transformations without Pronghorn admin permissions.
  • app-configuration_manager:3.74.24-2021.1.16 [10-18-2021] - Added bidirectional compliance functionality to ensure that specified config exists in a device.
  • app-configuration_manager:3.74.24-2021.1.15 [10-04-2021] - Improved performance handling for Golden Configurations with large datasets.
  • app-form_builder:4.10.1-2021.1.7 [09-29-2021] - Fixed Templates list in the side navbar when reviewing forms.
  • app-json_forms:1.30.12-2021.1.10 [10-21-2021] - Fixed a bug that occurred when importing JSON forms with the field collapsed.
  • app-jst:1.3.10-2021.1.39 [10-28-2021] - Updated query for transformations to check if the version property is in the correct format.
  • app-jst:1.3.10-2021.1.36 [10-14-2021] - Updated the query logic for transformations to migrate and removed the "migrated" property.
  • app-operations_manager:1.47.0-2021.1.47 [11-04-2021] - Fixed an issue with processAutomations so importing the automation in a prebuilt will reference the correct dependencies.
  • app-operations_manager:1.47.0-2021.1.46 [11-03-2021] - Fixed a bug in export of triggers which reference JSON Forms. All triggers with forms now include the formId property value.
  • app-operations_manager:1.47.0-2021.1.45 [10-18-2021] - Fixed UI bugs in the Automation Schedule Trigger form.
  • app-operations_manager:1.47.0-2021.1.44 [10-05-2021] - Fixed alignment of columns in the Quick Start welcome message.
  • app-workflow_builder:5.40.5-2021.1.35 [10-25-2021] - Fixed an issue with switching between Gen 1 and Gen 2 workflows.
  • app-workflow_builder:5.40.5-2021.1.33 [10-13-2021] - A new transformation for a given workflow can be created when editing a 'Child Job' task. When a transformation with a given name already exists, a new transformation will be created under the modified name.
  • app-workflow_builder:5.40.5-2021.1.32 [10-13-2021] - Fixed upload transformation interface to prevent creation of transformations with duplicate names when editing 'Run Transformation' task.
  • app-workflow_builder:5.40.5-2021.1.31 [10-13-2021] - Fixed a bug in the workflow schema that prevented an automation from being renamed.
  • app-workflow_builder:5.40.5-2021.1.30 [10-13-2021] - Added error details to a message displayed after an unsuccessful workflow creation.
  • app-workflow_builder:5.40.5-2021.1.29 [10-12-2021] - Fixed documentation links when creating new workflow.
  • app-workflow_engine:9.6.32-2021.1.86 [10-28-2021] - Updated the Retry Task path to fix an error seen when trying to GET workflow_engine/dialog/RetryTask.
  • app-workflow_engine:9.6.32-2021.1.84 [10-20-2021] - Fixed an issue where jobs in the Gen 2 workflow were not showing all iterations of the job on the Job Details page.
  • app-workflow_engine:9.6.32-2021.1.80 [10-13-2021] - JST variables will now show the origin of incoming variable.
  • app-workflow_engine:9.6.32-2021.1.77 [10-06-2021] - Modified the setObject method to fix the way nested objects are merged in the Merge task.
  • pronghorn-core:12.1.24-2021.1.60 [11-03-2021] - Added an importMap to process functions to handle dependencies when importing a prebuilt.
  • pronghorn-core:12.1.24-2021.1.59 [11-02-2021] - Fixed the loggerProps.webserver so it will no longer fail due to schema validation missing the webserver schema.
  • pronghorn-core:12.1.24-2021.1.57 [10-29-2021] - Set the /version endpoint to public for the non-pronghorn.admin user experience.
  • pronghorn-core:12.1.24-2021.1.54 [10-20-2021] - Fixed bug where updating the Local AAA adapter required additional brokers data.
  • pronghorn-core:12.1.24-2021.1.53 [10-20-2021] - If a new service is discovered on startup in an IAP environment it will be added to all IAP Profiles.
  • pronghorn-core:12.1.24-2021.1.52 [10-19-2021] - Remove filtering by versionStatus from getRepositoryPrebuilts API.
  • pronghorn-core:12.1.24-2021.1.51 [10-19-2021] - Fixed an issue with conflicting Pre-built Automation names from different repository configurations.
  • pronghorn-core:12.1.24-2021.1.50 [10-15-2021] - Fixed a bug that caused a failure due to missing authorization of a task imported from an integration.
  • pronghorn-core:12.1.24-2021.1.49 [10-11-2021] - Fixed an issue where an error message returns null when handling transformations that do not have a property name.
  • pronghorn-core:12.1.24-2021.1.48 [10-12-2021] - Fixed a misspelling of "capable" in an error message for Brokers.
  • pronghorn-core:12.1.24-2021.1.47 [10-12-2021] - Fixed an issue that was causing an invalid "Out of sync" message to appear on the Profile details page.
  • pronghorn-core:12.1.24-2021.1.46 [10-09-2021] - Errors from the createIndexes API call are now handled via callback function and the status is logged.

Chores

  • adapter-nso:7.1.3-2021.1.4 [10-14-2021] - Updated GitLab CI file for npm audit prod pipeline.
  • app-automation_studio:3.35.20-2021.1.72 [10-25-2021] - Updated JST and JST Designer dependencies to latest version.
  • app-automation_studio:3.35.20-2021.1.70 [10-18-2021] - Updated JST and JST Designer dependency to latest version.
  • app-automation_studio:3.35.20-2021.1.66 [10-08-2021] - Updated JST and JST Designer dependency to latest version.
  • app-jst:1.3.10-2021.1.38 [10-25-2021] - Updated JST and JST Designer dependencies to latest version.
  • app-jst:1.3.10-2021.1.37 [10-18-2021] - Updated JST and JST Designer dependencies to latest version.
  • app-jst:1.3.10-2021.1.35 [10-08-2021] - Updated JST and JST Designer dependency to latest version.
  • app-jst:1.3.10-2021.1.34 [10-01-2021] - Updated jst-designer dependency to latest version.

Tests

  • app-workflow_engine:9.6.32-2021.1.83 [10-15-2021] - Added test case for workflow engine error stringification.
  • app-workflow_engine:9.6.32-2021.1.82 [10-14-2021] - Un-skipped a test and made a few fixes in 'test/api/routes/workflowsVariables.get.js' .
  • app-workflow_engine:9.6.32-2021.1.81 [10-13-2021] - Fixed api tests for pauseJob.post.js.
  • app-workflow_engine:9.6.32-2021.1.78 [10-08-2021] - Updates tests to reflect new engine behavior.

2021.1.4 Release Versions

Automation Platform Versions

component version
@itential/adapter-automation_gateway 4.17.1-2021.1.2
@itential/adapter-azure_aaa 1.1.9-2021.1.0
@itential/adapter-email 3.1.20-2021.1.2
@itential/adapter-ldap 2.12.21-2021.1.2
@itential/adapter-local_aaa 4.2.8-2021.1.1
@itential/adapter-nso 7.1.3-2021.1.4
@itential/adapter-radius 2.0.12-2021.1.0
@itential/adapter-redis 2.0.17-2021.1.0
@itential/app-admin_essentials 2.25.42-2021.1.32
@itential/app-ag_manager 1.13.0-2021.1.2
@itential/app-automation_catalog 2.10.6-2021.1.12
@itential/app-automation_studio 3.35.20-2021.1.72
@itential/app-configuration_manager 3.74.24-2021.1.16
@itential/app-form_builder 4.10.1-2021.1.8
@itential/app-json_forms 1.30.12-2021.1.10
@itential/app-jst 1.3.10-2021.1.39
@itential/app-mop 6.10.2-2021.1.9
@itential/app-nso_manager 2.20.15-2021.1.2
@itential/app-operations_manager 1.47.0-2021.1.47
@itential/app-service_catalog 3.10.19-2021.1.1
@itential/app-service_management 2.24.0-2021.1.1
@itential/app-template_builder 2.5.3-2021.1.3
@itential/app-workflow_builder 5.40.5-2021.1.35
@itential/app-workflow_engine 9.6.32-2021.1.86
@itential/pronghorn-core 12.1.24-2021.1.60
@itential/search 1.1.14-2021.1.1
@itential/tags 3.1.4-2021.1.0
@itential/itential-utils 2.7.2

Automation Gateway Versions

component version
automation_gateway 3.130.2+2021.1.23

NSO Manager Versions

component version
itential-tools 1.23.31.2021.1.4

Engine Versions

component version
policy-engine 1.10.7+2021.1.0

Dependencies

Automation Platform Server

package supported versions recommended version
nodejs >= 12.22.1 <= 14 14.17.3
npm 6.x 6.14.15
python 2.x or 3.x 3.9.7
pip supported recommended
pip any version 21.2.4
textfsm 1.x 1.1.2
Jinja2 2.x 2.11.3

The gcc-c++ and make packages should be installed from your OS distribution.

Mongo Server

package supported recommended
mongodb 4.2.x 4.2.13

RabbitMQ Server

package supported recommended
rabbitmq 3.8.x 3.8.14
erlang 21.3+ or 22.x 22.3.1
elixir 1.10.x 1.10.4
dedup 0.5.x 0.5.0

Redis Server

package supported recommended
redis 5.x 5.0.12

The gcc-c++ and make packages should be installed from your OS distribution.

Hashicorp Vault

package supported recommended
vault 1.x 1.7.0

Automation Gateway

package supported recommended
python 3.9 3.9.7
openssl 1.x 1.1.1l
haproxy 2.x 2.2.14

The gcc-c++ and make packages should be installed from your OS distribution.

The following development packages are required to install automation gateway: libffi-dev, openssl-dev, python-dev, sqlite-dev.

pip package supported recommended
pip 20.2.4 20.2.4
ansible 2.9 or 2.10 2.10.7
terraform 0.12.x 0.12.31
nornir 3.x 3.1.1
netmiko 3.x 3.4.0

One or more of the following packages may be required by the specific ansible modules you're using: psutil, pycrypto, paramiko, ncclient, lxml, nitrosdk-python, jxmlease.

Check the ansible documentation for the roles you're planning to use for additional package requirements.

NSO/Itential Tools

package supported recommended
java 1.7 or 1.8 1.8.275.01

The ant package should be installed from your OS distribution.

IAP Compatibility

Device Configuration

Device Configuration compatibility describes which devices are expected to work with the basic features of the Configuration Manager application across various southbound systems.

Ansible: 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

Refer to the NSO Versions and NED Versions tables below for a list of tested devices.

Device Compliance

Device Compliance compatibility describes which devices are expected to work with Golden Configurations.

Ansible: 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO (Configuration Manager app): 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

Device Maintenance

Device Maintenance compatibility describes which devices Itential can perform maintenance activities on (e.g., reboots and firmware upgrades).

Ansible: 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Juniper Junos

NSO: 

* cisco-ios
* cisco-iosxr
* juniper-junos

Device Health Checks

Device Health Checks compatibility describes which devices Itential can execute read-only show commands to use the method broker and Command Templates application.

Ansible: 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO: 

* a10-acos
* alu-sr
* arista-dcs
* cienacli-acos
* cisco-aireos
* cisco-asa
* cisco-gss
* cisco-ios
* cisco-iosxr
* cisco-nx
* cisco-qps
* cisco-staros
* ericsson-sgsnmme
* f5-bigip
* huawei-vrp
* juniper-junos

Note: Some of the devices in the health checks category are tested against netsim devices.

Forms

Ansible:

IAP can render most ansible networking modules as forms. Support for specific modules may vary. If you encounter issues with any particular modules, reach out to the Itential Customer Success Team for assistance.

NSO:

IAP can render most service models advertised by NSO as forms. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Customer Success Team for assistance.

Service Provisioning

NSO:

IAP can provision most service models advertised by NSO. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Customer Success Team for assistance.

Devices/Services Compatibility

The Itential Automation Platform is tested against the following component versions.

Ansible Versions:

* 2.10.7
* 2.9.27

Ansible Modules:

* eos_facts
* eos_command
* eos_config
* ios_facts
* ios_command
* ios_config
* iosxr_facts
* iosxr_command
* iosxr_config
* nx_facts
* nx_command
* nx_config
* junos_facts
* junos_command
* junos_config

NSO Versions:

* 5.4.4
* 5.5.1

NSO NED Versions:

ned 5.4.4 5.5.1
a10-acos 3.18 3.18
adtran-aos 4.0.6 4.0.6
alu-sr 8.13.4 8.13.4
8.13.3
arista-dcs 5.20.2 5.20.2
5.20
checkpoint-gaiaos_rest n/a 1.10.7
1.10.6
ciena-acos 6.2.5 6.2.5
6.2.4
cisco-aireos 3.7.2
3.7.1		 3.7.2
3.7.1
cisco-asa 6.12.4 6.12.4
6.12.3
cisco-gss 2.1.1 2.1.1
cisco-ios 6.69
6.68.2		 6.69
6.68.2
cisco-iosxr 7.33 7.33
7.32.5
cisco-nx 5.21.1 5.21.1
5.21
cisco-qps 5.1.3 5.1.3
cisco-staros 5.34.6
5.34.5		 5.34.6
5.34.5
ericsson-sgsnmme 1.0.7 n/a
f5-bigip 3.17
3.16		 3.17
3.16
fortinet-fortios 5.4.21 5.4.21
5.4.20
huawei-usn 1.2.1 n/a
huawei-vrp 6.17.4
6.17.3		 6.17.4
6.17.3
juniper-junos 4.6.19
4.6.17		 4.6.19
4.6.17
paloalto-panos_cli 4.8.2
4.8.1		 4.8.2
4.8.1
radware-alteonos 2.4.1 2.4.1
2.4
unix-bind 2.1.0 2.1.0

VTS Versions:

* 2.6.2

VTS NED Versions:

ned 2.6.2
cisco-iosxr 6.6
cisco-ncs5500 1.0
cisco-nx 5.1.4

Virtual Devices:

* A10 vThunder 4.1.4 GR1
* Arista EOS-4.23.0FX
* Checkpoint R80.30-273.583
* Cisco ASAv 9.13.1.7
* Cisco CSR 17.02.01r
* Cisco NX 9.3.2, 9.3.1
* Cisco StarOS 21.15.29
* Cisco XR6.3.1
* F5 BIGIP 15.1.0.2-0.0.9
* Fortigate 6.4.0
* Juniper VMX 18.4R1
* Juniper VSRX 19.1R2
* PanOS 9.1.2
* Radware 32.6.0.0

IAP Browser Compatibility

This maintenance release was tested against the following browser versions:

* Firefox 89
* Chrome 91.0.4472.77
* Edge 91.0.864.37
* Internet Explorer 11